home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro129 / draw256.doc < prev    next >
Encoding:
Text File  |  1992-12-08  |  13.5 KB  |  384 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         Draw256 v2.20 Documentation
  7.                              December 8, 1992
  8.  
  9.             Draw256 software and manual are copyright (c) 1992
  10.                by Matthew Hildebrand.  All rights reserved.
  11.  
  12.  
  13.  
  14.  
  15. Topics covered in this document:
  16. -------------------------------
  17.  
  18.      INTRODUCTION
  19.      MAJOR FEATURES OF Draw256
  20.      SYSTEM REQUIREMENTS
  21.      PACKING LIST
  22.      RELEASE NOTES FOR v2.20
  23.      User's Guide:
  24.           USING Draw256
  25.           HELP
  26.           AIRBRUSH
  27.           CHANGING THE IMAGE DIMENSIONS
  28.           EDITING THE COLOUR PALETTE
  29.           REGION FILLS
  30.           ERASING
  31.           SAVING AND LOADING IMAGES
  32.           MAGNIFYING PORTIONS OF AN IMAGE
  33.           STARTING A NEW IMAGE
  34.           THE PALETTE MENU
  35.           RANDOM COLOURS
  36.           STAMPS
  37.           EXITING Draw256
  38.           DOS SHELL
  39.           CONFIGURING Draw256
  40.      TERMS OF USAGE AND DISTRIBUTION
  41.      CONTACTING THE AUTHOR
  42.      OBTAINING Draw256
  43.      REVISION HISTORY
  44.      ACKNOWLEDGEMENT
  45.      LEGAL MUMBO JUMBO
  46.  
  47.  
  48.  
  49. INTRODUCTION
  50.  
  51.      Draw256 is the result of my efforts to construct an easily available
  52.      and cheap art package for the PC.  It incorporates some of the
  53.      features that I have looked for in an art package, usually without
  54.      success.
  55.      Draw256 is one of a handful of non-commercial art packages that I know
  56.      of.  I hope that it will help fill the requirements of users. 
  57.  
  58.  
  59. MAJOR FEATURES OF Draw256
  60.  
  61.      It's free.
  62.  
  63.      Draw256 uses loadable graphics drivers.  This means that Draw256 can
  64.      be modified to work with a different video card simply by installing
  65.      the appropriate driver.
  66.  
  67.      Both EMS (Expanded) and XMS (Extended) memory are used, making much
  68.      more room for image data.
  69.  
  70.      Images varying in size from one pixel by one pixel to the size of
  71.      available memory can be manipulated.
  72.  
  73.      The workspace isn't cluttered.  I got fed up with art packages that
  74.      filled the screen with icons, leaving only a small space in which to
  75.      draw.  In Draw256, the entire screen is the workspace.  Instead of
  76.      distracting icons, almost every command is available with a single
  77.      keystroke.
  78.  
  79.      Many art packages require that certain palette entries be left
  80.      unaltered, so that their system colours remain intact.  Draw256 is
  81.      adaptive; from any palette, Draw256 will use the colour that most
  82.      closely matches the actual colour it needs at the time.  This strategy
  83.      leaves all palette entries open for editing, and makes palette editing
  84.      simpler.
  85.  
  86.  
  87. SYSTEM REQUIREMENTS
  88.  
  89.      Draw256 requires:  a 286 processor or higher, a Microsoft or
  90.      compatible mouse and mouse driver, a VGA or compatible video card, and
  91.      about 500 Kb of conventional memory.
  92.  
  93.      Draw256 will be happier if it is run on a 386 or higher processor.  In
  94.      this case, it will make use of any available EMS and/or XMS memory.
  95.  
  96.      In order to use the 320x240 and 320x400 drivers, a register-compatible
  97.      VGA card is required.  For most users, this requirement should not
  98.      present a problem.
  99.  
  100.  
  101. PACKING LIST
  102.  
  103.      The current version of Draw256 consists of the following files:
  104.  
  105.           DRAW256.DOC    This file
  106.           DRAW256.EXE    The program code
  107.           DRAW256.CFG    The configuration file
  108.           320X200.DRV    Graphics driver for VGA 320x200x256 mode
  109.           320X240.DRV    Graphics driver for VGA 320x240x256 mode
  110.           320X400.DRV    Graphics driver for VGA 320x400x256 mode
  111.           640X480.DRV    Graphics driver for SuperVGA/VESA 640x480x256 mode
  112.                          (autodetect)
  113.           800X600.DRV    Graphics driver for SuperVGA/VESA 800x600x256 mode
  114.                          (autodetect)
  115.           ANGULAR.FNT    Font definition file
  116.  
  117.      If you did not receive all of these files, you have an illegal copy of
  118.      Draw256.
  119.  
  120.  
  121. RELEASE NOTES FOR v2.20
  122.  
  123.      Draw256 now has SuperVGA support.  However, due to the large number of
  124.      SuperVGAs supported, I have not been able to test the SuperVGA code
  125.      with all SuperVGA cards.  I would very much appreciate hearing of any
  126.      bugs in the SuperVGA code (or any other bugs).
  127.  
  128.      Draw256 may exhibit unusual behaviour when it is run under tight
  129.      memory constraints.  For best results, give Draw256 plenty of memory.
  130.  
  131.  
  132. USING Draw256
  133.  
  134.      Although it may be slightly intimidating at first, Draw256 is easy to
  135.      use.  Simply run DRAW256.EXE, and it's ready.
  136.  
  137.      To draw, hold down the left mouse button while moving the mouse. 
  138.      Alternatively, you may use the numeric keypad to draw by pressing any
  139.      of the eight direction keys while either NumLock is active or a Shift
  140.      key is pressed.  To draw a single pixel at the current pointer
  141.      position, press the spacebar.
  142.  
  143.      To select a new drawing colour, click the right mouse button.  Click
  144.      the left button on the colour you wish to draw with.  To abort, either
  145.      hit ESC or click the right button once again.
  146.  
  147.      When images larger than the screen are being worked with, the portion
  148.      of the image being displayed can be changed with Ctrl-key
  149.      combinations.  Ctrl-left moves left, Ctrl-down moves down, Ctrl-Home
  150.      moves to the upper-left, Ctrl-5 moves to the center, Ctrl-PgDn moves
  151.      to the lower-right, and so on.  All eight direction keys and the 5 on
  152.      the numeric keypad can be used.
  153.  
  154.      The other keys are reserved for more specific functions.  Read on for
  155.      a more detailed description.
  156.  
  157.  
  158. HELP
  159.  
  160.      For help, hit the F1 key.
  161.  
  162.  
  163. AIRBRUSH
  164.  
  165.      The 'A' key will toggle the airbrush on/off.
  166.  
  167.  
  168. CHANGING THE IMAGE DIMENSIONS
  169.  
  170.      Draw256 supports images ranging in size from one pixel to the size of
  171.      available memory.  To change the dimensions, press 'D', then enter the
  172.      new width and depth as prompted.  Caution:  this procedure will
  173.      destroy the current image.
  174.  
  175.  
  176. EDITING THE COLOUR PALETTE
  177.  
  178.      The VGA's default palette, is, at best, lousy.  Draw256 allows you to
  179.      edit each of the 256 available colours to your liking.  To do so,
  180.      press 'E', then select the colour you wish to edit.  Play around with
  181.      the up, down, left, and right keys; you'll learn the controls soon
  182.      enough.
  183.  
  184.  
  185. REGION FILLS
  186.  
  187.      Draw256 allows you to fill a portion of the current image with a
  188.      colour.  To do so, position the mouse pointer in the region you wish
  189.      to fill, then press 'F'.  The fill routine I wrote will fill, using
  190.      the current drawing colour, until a colour other than that of the
  191.      region is encountered.
  192.  
  193.  
  194. ERASING
  195.  
  196.      To erase part of the current image, press 'K'.  When the left mouse
  197.      button is pressed, the area inside the rectangle will be blanked with
  198.      the current drawing colour.
  199.  
  200.  
  201. SAVING AND LOADING IMAGES
  202.  
  203.      Images may be saved and loaded in either Draw256's own .VGA format, or
  204.      the .PCX format.  To save, press 'S'; to load, press 'L'.  Afterwards,
  205.      type in the name of the file.  (Caution:  if you are saving, and the
  206.      file you enter exists, it will be overwritten.)
  207.  
  208.      No extension is necessary on the filenames.  If none is present, the
  209.      default extension will be assumed (See "CONFIGURING Draw256").  If the
  210.      extension exists, and is either .VGA or .PCX, the save or load will be
  211.      forced to that format.
  212.  
  213.  
  214. MAGNIFYING PORTIONS OF AN IMAGE
  215.  
  216.      To activate the magnification feature, press 'M', then select the area
  217.      you wish to magnify.  During magnification, new colours may be
  218.      selected.
  219.  
  220.      To accept the changes made during magnification, press either 'M' or
  221.      Enter.  To abort the changes, press ESC.
  222.  
  223.  
  224. STARTING A NEW IMAGE
  225.  
  226.      To completely abandon the current image and start a new one, press
  227.      'N'.
  228.  
  229.  
  230. THE PALETTE MENU
  231.  
  232.      To access the palette menu, press 'P'.  From this menu, palettes may
  233.      be saved and loaded, in either the raw binary .PAL format, or
  234.      Fractint's .MAP format.  .PAL files are smaller and slightly faster,
  235.      but utterly illegible.  .MAP files are suitable for editing, and are
  236.      much more easily read.
  237.  
  238.  
  239. RANDOM COLOURS
  240.  
  241.      If for some reason you wish to draw with the current colour constantly
  242.      changing, you may do so.  Press 'R' to toggle the random colours
  243.      on/off.  This option can produce an interesting effect, especially
  244.      when used in conjunction with the airbrush.
  245.  
  246.  
  247. STAMPS
  248.  
  249.      A "stamp" is a portion of an image which may be easily placed anywhere
  250.      on an image.
  251.  
  252.      To cut a stamp, press 'C', then hold down the left mouse button and
  253.      move the mouse until the area you wish to use as the current stamp is
  254.      outlined.
  255.  
  256.      To write the current stamp, press 'W', then move the mouse and click
  257.      the left button wherever you wish to place the stamp.  Click the right
  258.      mouse button or press ESC when finished.
  259.  
  260.      To access the stamp menu, press 'T'.  Cutting and pasting are
  261.      accessible through this menu, as are saving and loading of stamps. 
  262.      Stamps may be stored on disk in either Draw256's .VGA format or the
  263.      .PCX format.
  264.  
  265.  
  266. EXITING Draw256
  267.  
  268.      To exit Draw256, press ESC.
  269.  
  270.  
  271. DOS SHELL
  272.  
  273.      To shell to DOS, press F10.
  274.  
  275.  
  276. CONFIGURING Draw256
  277.  
  278.      Draw256 comes ready to use.  However, several changes may be made by
  279.      editing the file DRAW256.CFG with a text editor.  There are two types
  280.      of lines in DRAW256.CFG:  comment lines, which have a semicolon in the
  281.      first column, and configuration lines, which consist of, in order, a
  282.      valid configuration directive, some whitespace, and a valid parameter
  283.      for that directive.
  284.  
  285.      Valid directives are:
  286.           GRAFDRV        The filename of the graphics driver to be used
  287.           FONT           The filename of the font to use
  288.           DEFAULTPAL     The filename of a .PAL to be loaded automatically
  289.           DEFAULTMAP     The filename of a .MAP to be loaded automatically
  290.           DRAWCOLOUR     The default drawing colour (defaults to 0)
  291.           HORIZMOUSE     Horizontal mouse sensitivity, in mickeys per pixel
  292.           VERTMOUSE      Vertical mouse sensitivity, in mickeys per pixel
  293.           IMAGEWIDE      The default image width (defaults to screen width)
  294.           IMAGEDEEP      The default image depth (defaults to screen depth)
  295.           IMAGETYPE      The default image type:  either .PCX or .VGA
  296.                          (defaults to .VGA)
  297.  
  298.      DRAW256.CFG must include at least one GRAFDRV and at least one FONT
  299.      directive.
  300.  
  301.      The mickey is the unit used to measure mouse movement.  Smaller
  302.      numbers will produce greater sensitivity, while large numbers will
  303.      decrease sensitivity.
  304.  
  305.      When more than one of the same directive is present, the last one is
  306.      used.
  307.  
  308.  
  309. TERMS OF USAGE AND DISTRIBUTION
  310.  
  311.      The Draw256 software and its associated documentation are copyright
  312.      (c) 1992 by Matthew Hildebrand.  All rights are reserved.
  313.  
  314.      Draw256 is freeware; although it is free, donations are greatly
  315.      appreciated.  If you find that you like Draw256, please send me
  316.      whatever you think it is worth.  I cannot continue to work on projects
  317.      such as Draw256 without compensation.  Contributions of any kind to
  318.      help improve this project are welcome.
  319.  
  320.      Circulation of the Draw256 package is permitted and encouraged,
  321.      provided that the following conditions are met:
  322.           1.   The package is distributed in its complete and unmodified
  323.                form, consisting of the files listed in the "PACKING LIST"
  324.                section.
  325.           2.   Draw256 is not sold for profit.
  326.      For any exception to the above conditions, written permission from the
  327.      author is required.
  328.  
  329.  
  330. CONTACTING THE AUTHOR
  331.  
  332.      I would appreciate hearing any questions, comments, bug reports, or
  333.      suggestions for improvement.  If you have any, feel free to contact
  334.      me.  I can be reached at either of the following addresses.
  335.  
  336.      Snail mail:
  337.           Matthew Hildebrand
  338.           4 College St.
  339.           St. Catharines, ON
  340.           Canada
  341.           L2R 2W7 
  342.  
  343.      Fido NetMail:
  344.           1:247/128.2
  345.  
  346.  
  347. OBTAINING Draw256
  348.  
  349.      The most recent copy of Draw256 may be obtained via File Request from
  350.      1:247/128 (14.4K V.32bis) using the magic file name "DRAW256". 
  351.      Unlisted nodes and points are welcome.  Draw256 is also available via
  352.      first-call download from 1:247/128 at (416)-935-6628.
  353.  
  354.  
  355. REVISION HISTORY
  356.  
  357.      2.20    - Added 640x480x256 and 800x600x256 SuperVGA support with the
  358.                addition of the files 640X480.DRV and 800X600.DRV.
  359.              - Added "Error initializing graphics hardware" message.
  360.              - Stamps can now be saved in either .VGA or .PCX format.
  361.              - Fixed several bugs which manifested themselves when memory
  362.                became low.
  363.              - Fixed bug which sometimes caused a crash when panning over
  364.                large images.
  365.  
  366.      2.11      First public release.
  367.  
  368.  
  369. ACKNOWLEDGEMENT
  370.  
  371.      There are some people whom I would like to thank for their
  372.      suggestions, beta-testing, and patience.  You know who you are.
  373.  
  374.  
  375. LEGAL MUMBO JUMBO
  376.  
  377.      The Draw256 software and documentation are provided "as is", and
  378.      without warranty of any kind.  The author may not be held liable for
  379.      any damage or misfortune that the usage of this software may cause. 
  380.      Although the Draw256 software has undergone extensive testing, there
  381.      is a chance that it may crash anyway.
  382.  
  383.      All registered trademarks in this document belong to whoever it is
  384.      that owns them.